home *** CD-ROM | disk | FTP | other *** search
/ Stone Design / Stone Design.iso / Stone_Friends / Wave / WavesWorld / Source / Libraries / tcl7.4b3 / doc / append.n < prev    next >
Encoding:
Text File  |  1994-12-17  |  952 b   |  33 lines
  1. '\"
  2. '\" Copyright (c) 1993 The Regents of the University of California.
  3. '\" Copyright (c) 1994 Sun Microsystems, Inc.
  4. '\"
  5. '\" See the file "license.terms" for information on usage and redistribution
  6. '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  7. '\" 
  8. '\" @(#) append.n 1.3 94/12/17 16:17:38
  9. '\" 
  10. .so man.macros
  11. .HS append tcl
  12. .BS
  13. '\" Note:  do not modify the .SH NAME line immediately below!
  14. .SH NAME
  15. append \- Append to variable
  16. .SH SYNOPSIS
  17. \fBappend \fIvarName \fR?\fIvalue value value ...\fR?
  18. .BE
  19.  
  20. .SH DESCRIPTION
  21. .PP
  22. Append all of the \fIvalue\fR arguments to the current value
  23. of variable \fIvarName\fR.  If \fIvarName\fR doesn't exist,
  24. it is given a value equal to the concatenation of all the
  25. \fIvalue\fR arguments.
  26. This command provides an efficient way to build up long
  27. variables incrementally.
  28. For example, ``\fBappend a $b\fR'' is much more efficient than
  29. ``\fBset a $a$b\fR'' if \fB$a\fR is long.
  30.  
  31. .SH KEYWORDS
  32. append, variable
  33.